home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / addhost / addhost.man < prev    next >
Text File  |  1990-02-13  |  5KB  |  134 lines
  1. '\" Copyright 1989 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/cmds/addhost/RCS/addhost.man,v 1.4 90/02/13 15:40:57 jhh Exp $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS ADDHOST cmds
  13. .BS
  14. '\" Note:  do not modify the .SH NAME line immediately below!
  15. .SH NAME
  16. addhost \- Add a new host to the system
  17. .SH SYNOPSIS
  18. \fBaddhost\fR [\fIoptions\fR] [\fB\-n \fIname\fR \fB\-i \fIinternet\fR \fB\-a \fInetAddress\fR \fB\-m \fImachineType\fR \fB\-s\fR \fIswapDir\fR]
  19. .SH OPTIONS
  20.  
  21. .IP "\fB\-a \fIaddress\fR" 15
  22. The \fB\-a\fR flag is required, and is used to set the local network
  23. address of the host.
  24. Usually \fIaddress\fR is an Ethernet address, and is of the form
  25. "a:b:c:d:e:f".
  26.  
  27. .IP "\fB\-d \fIdomain\fR" 15
  28. Used to set the local domain.  
  29. The \fIdomain\fR string is appended to the name provided by the \fB\-n\fR
  30. flag to produce the full name of the machine.
  31. The default is to parse the domain name from the \fIspritehosts\fR file.
  32. If the file is empty then the \fB\-d\fR flag must be given.
  33.  
  34. .IP "\fB\-h\fR, \fB\-help\fR, \fB\-?\fR" 15
  35. These options cause a help listing to be printed.
  36.  
  37. .IP "\fB\-i \fIinternet\fR" 15
  38. \fIInternet\fR is the internet address of the host. 
  39. The address is in the form "a.b.c.d".
  40. This flag is required.
  41.  
  42. .IP "\fB\-I \fIspriteID\fR" 15
  43. The \fB\-I\fR flag is used to assign a Sprite ID to the host.
  44. Care must be taken that \fIspriteID\fR does not conflict with the id
  45. of an existing host.
  46. If the \fB\-I\fR flag is omitted \fBaddhost\fR will use a Sprite ID
  47. that is one greater than the largest id found in the \fIspritehosts\fR file.
  48.  
  49. .IP "\fB\-m \fImachineType\fR" 15
  50. This flag sets the machine type of the host to be added. 
  51. This flag must be used.
  52. Supported machine types are \fIsun3\fR, \fIsun4\fR, \fIsun4c\fR, and 
  53. \fIds3100\fR.
  54.  
  55. .IP "\fB\-n \fIname\fR" 15
  56. \fIName\fR is the name of the host. 
  57. This flag is required.
  58.  
  59. .IP "\fB\-s \fIswapDir\fR" 15
  60. The \fB\-s\fR defines \fIswapDir\fR to be the directory in which to 
  61. create the swap directory for the new host.
  62. The default is /swap.
  63. If a different directory is specified then a link will be make in /swap.
  64.  
  65. .IP "\fB\-t \fInetType\fR" 15
  66. The \fB\-t\fR flag is used to set the type of the network associated with
  67. the host.
  68. The default is \fIether\fR, indicating that the host is connected to the
  69. system via an Ethernet, and the the argument to the \fB\-a\fR flag is 
  70. the Ethernet address of the host.
  71. The only other supported value for the \fInetType\fR argument
  72. is \fIinet\fR,
  73. indicating that a gateway exists between the host and the root file server.
  74. In this case the argument to the \fB\-a\fR flag is the Ethernet address
  75. of the gateway machine.
  76.  
  77. .IP "\fB\-R\fR" 15
  78. \fBAddhost\fR will not allow a host to be added if the name of the
  79. new host conflicts with the name of an existing host.
  80. If the \fB\-R\fR flag is specified than the existing host information
  81. is replaced with the information for the new host.
  82. If you are upgrading a machine from one machine type to another but
  83. retaining the name then the \fB\-R\fR flag should be used.
  84.  
  85. .IP "\fB\-r \fIroot\fR" 15
  86. The \fB\-r\fR flag is used to specify that the root of the Sprite
  87. filesystem is something other than "/".  
  88. .BE
  89.  
  90. .IP "\fB\-o \fIowner\fR" 15
  91. Used to specify the owner or primary user of the machine.
  92. This information is added to /sprite/admin/hosts.
  93.  
  94. .IP "\fB\-l \fIlocation\fR" 15
  95. Used to specify the location of the machine.
  96. This information is added to /sprite/admin/hosts.
  97.  
  98. .IP "\fB\-T \fImachine description\fR" 15
  99. The \fB\-T\fR
  100. flag is used to specify the full machine description.
  101. Examples might be "sun3/75" or "sun4/260".
  102. This information is added to /sprite/admin/hosts.
  103.  
  104.  
  105.  
  106. .SH DESCRIPTION
  107. .PP
  108. The \fBaddhost\fR command is used to add a new host to the system.
  109. It should only be run by the super-user (root).
  110. Invoking \fBaddhost\fR without any options will cause it to run in
  111. an interactive mode where you will be prompted for the host name,
  112. type, etc.
  113. These parameters can also be set via options on the command line.
  114. The use of any options causes \fBaddhost\fR to not run interactively.
  115. In this case a minimum set of options must be used.
  116. The \fB\-a\fR, \fB\-i\fR, \fB\-n\fR, \fB\-m\fR, and \fB\-s\fR flags
  117. must be used to
  118. indicate the local address, Internet address, host name, host machine
  119. type, and swap directory, respectively.
  120. The options are described in more detail in the section above.
  121. .PP
  122. As the \fBaddhost\fR script runs it will print out information on the actions
  123. it is taking.
  124. Once the script is complete you should look in /sprite/admin/howto/addNewHost
  125. for any remaining steps in the installation procedure.
  126.  
  127. .SH FILES
  128. The following files are edited by \fBaddhost\fR:
  129. /etc/spritehosts, /etc/hosts.equiv, /sprite/admin/hosts
  130.  
  131. .SH KEYWORDS
  132. spritehosts, new, host, hosts, hosts.equiv
  133.  
  134.